@vint.tri/report_gen_mcp 1.7.26 → 1.7.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,1025 +1,81 @@
1
- # ИСПРАВЛЕННЫЕ Инструкции для нейросети по работе с инструментом report_gen_mcp v1.5.9
1
+ # Финальные инструкции для нейросети по работе с инструментом report_gen_mcp v1.8.0
2
2
 
3
3
  **ВАЖНО:** ВСЕГДА ИСПОЛЬЗУЙТЕ ИНСТРУМЕНТ `report_gen_mcp` КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ЗАПРАШИВАЕТ СОЗДАНИЕ ОТЧЕТА, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК ИЛИ ЛЮБОЕ ИЗМЕНЕНИЕ СУЩЕСТВУЮЩЕГО ОТЧЕТА!
4
4
 
5
- Этот документ содержит специальные инструкции для нейросети при работе с инструментом `report_gen_mcp`, чтобы обеспечить правильное взаимодействие с пользователем после генерации отчетов.
5
+ ## 1. Обязательное использование инструмента
6
6
 
7
- ## Обязательное использование инструмента
7
+ **КЛЮЧЕВОЕ ПРАВИЛО:** При любом запросе пользователя, связанном с созданием или изменением отчетов, диаграмм или графиков, вы **обязаны** использовать инструмент `report_gen_mcp`. Не пытайтесь создавать отчеты вручную.
8
8
 
9
- **КЛЮЧЕВОЕ ПРАВИЛО:** КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ХОЧЕТ ПОЛУЧИТЬ ОТЧЕТ, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК, ИЛИ ПОПРОСИТЬ ЧТО-ЛИБО ДОБАВИТЬ/ИЗМЕНИТЬ В СУЩЕСТВУЮЩЕМ ОТЧЕТЕ, НЕЗАВИСИМО ОТ ФОРМАТА ЗАПРОСА, ВЫ ДОЛЖНЫ ИСПОЛЬЗОВАТЬ ИНСТРУМЕНТ `report_gen_mcp`!
9
+ ## 2. Требования к качеству отчетов
10
10
 
11
- НЕ пытайтесь создавать отчеты самостоятельно или предлагать пользователю делать это вручную. ВСЕГДА используйте инструмент `report_gen_mcp`.
11
+ Каждый сгенерированный отчет должен быть:
12
+ - **Информативным:** Содержать анализ данных, выводы и рекомендации.
13
+ - **Визуально насыщенным:** Включать **как минимум одну диаграмму и одно изображение**, релевантные теме отчета.
14
+ - **Красиво оформленным:** Использовать заголовки, списки и выделение текста для лучшей читаемости.
12
15
 
13
- ## Общие принципы работы
16
+ ## 3. Работа с файлами
14
17
 
15
- При использовании инструмента `report_gen_mcp` для генерации отчетов, нейросеть должна следовать определенному протоколу взаимодействия с пользователем, чтобы обеспечить полную и удобную работу с созданными отчетами.
18
+ - **Сохранение:** Все отчеты автоматически сохраняются в **системную временную директорию**. Вам не нужно указывать полный путь только имя файла в параметре `outputFile`.
19
+ - **Возврат данных:** Инструмент вернет вам полный путь к созданному файлу, который вы должны предоставить пользователю вместе со ссылками для просмотра.
16
20
 
17
- ## Поддерживаемые элементы отчета
21
+ ## 4. Формат параметров (КРИТИЧЕСКИ ВАЖНО!)
18
22
 
19
- Инструмент поддерживает вставку в отчеты следующих элементов:
20
- 1. **Диаграммы** (charts) - различные типы графиков (bar, line, pie, doughnut, radar, polarArea)
21
- 2. **Изображения** (images) - два типа:
22
- - Сгенерированные сервисом pollinations.ai по текстовому описанию
23
- - По URL из интернета
24
- - **ВАЖНО:** Локальные файлы на компьютере пользователя также поддерживаются, но они должны быть указаны как относительные пути или абсолютные пути в системе пользователя
23
+ ### 4.1. Параметр `elements`
25
24
 
26
- ## Требования к оформлению отчетов
25
+ - `elements` **ВСЕГДА** должен быть **ОБЪЕКТОМ**, а не строкой.
27
26
 
28
- При создании отчетов необходимо придерживаться следующих требований по оформлению:
27
+ - **НЕПРАВИЛЬНО:** `"elements": "{...}"`
28
+ - ✅ **ПРАВИЛЬНО:** `"elements": {...}`
29
29
 
30
- 1. **Красивое форматирование**:
31
- - Используйте заголовки разных уровней (H1, H2, H3) для структурирования контента
32
- - Добавляйте списки (маркированные и нумерованные) для лучшей читаемости
33
- - Используйте выделение важной информации (жирный шрифт, курсив)
34
- - Разделяйте смысловые блоки пустыми строками
30
+ ### 4.2. Параметры диаграмм (`charts`)
35
31
 
36
- 2. **Визуализация данных**:
37
- - Всегда добавляйте диаграммы для числовых данных
38
- - Выбирайте подходящий тип диаграммы в зависимости от характера данных
39
- - Добавляйте поясняющие подписи к диаграммам
40
- - Используйте разнообразные цвета для лучшей визуализации
41
- - **ВАЖНО**: Все диаграммы автоматически создаются с адекватными размерами (примерно 400x300 пикселей) для лучшего визуального восприятия и пропорциональности в отчете
42
- - Диаграммы автоматически оборачиваются в контейнеры с CSS классами для обеспечения правильного масштабирования и отступов
43
- - Все диаграммы должны быть интерактивными (с использованием Chart.js)
32
+ - **Массивы, массивы и еще раз массивы!**
33
+ - `labels`: **ВСЕГДА** массив строк. `["Январь"]`
34
+ - `data`: **ВСЕГДА** массив чисел. `[100]`
35
+ - `backgroundColor`: **ВСЕГДА** массив строк. `["red"]`
36
+ - `borderColor`: **ВСЕГДА** массив строк. `["blue"]`
37
+ - `options.title`: **ВСЕГДА** простая строка. `"Мой график"`
44
38
 
45
- 3. **Изображения**:
46
- - Добавляйте тематические изображения для иллюстрации контента
47
- - Используйте изображения высокого качества
48
- - Добавляйте альтернативный текст для изображений
49
- - При необходимости регулируйте размеры изображений
50
- - Каждый отчет должен содержать картинку, отражающую его суть
51
- - **ОСОБЕННОСТИ РАБОТЫ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
52
- * При использовании локальных файлов изображений (file://) браузеры могут блокировать их отображение по соображениям безопасности
53
- * Для просмотра отчетов с локальными изображениями рекомендуется использовать Web link 2 (http://localhost:3000/...)
54
- * Альтернативно, пользователь может открыть файл напрямую в браузере через file:// ссылку
39
+ **Примечание:** Система теперь пытается автоматически исправлять некоторые ошибки форматирования (например, одиночные значения в массивы или парсинг строки `elements`), но для гарантированной работы **всегда** придерживайтесь правильного формата.
55
40
 
56
- 4. **Анализ данных**:
57
- - Каждый отчет должен содержать подробный анализ данных
58
- - Анализ должен включать выводы, закономерности и рекомендации
59
- - Используйте структурированный подход к анализу с выделением ключевых моментов
41
+ ## 5. Пример идеального вызова
60
42
 
61
- 5. **Сравнительные графики**:
62
- - Если отчет объединяет несколько сущностей, все их нужно отражать в одних и тех же сравнительных графиках
63
- - Используйте разные цвета и стили для различения сущностей на графиках
64
- - Добавляйте легенды и пояснения для лучшего понимания сравнительных данных
65
-
66
- 6. **Текстовое форматирование**:
67
- - Текст в отчетах автоматически форматируется с использованием HTML-разметки для улучшения читаемости
68
- - Отчеты имеют профессиональный внешний вид с улучшенным стилем, включая:
69
- * Четкую типографику с выравниванием текста по ширине
70
- * Стилизованные заголовки с цветовой индикацией
71
- * Улучшенное оформление списков и абзацев
72
- * Цветовое выделение важной информации (жирный шрифт красного цвета, курсив зеленого цвета)
73
- - Следите за форматированием текста, графиков и картинок - они не должны быть на весь экран
74
- - Все элементы должны быть оформлены в лучших традициях отчетности с соблюдением пропорций и отступов
75
-
76
- ## Работа с существующими отчетами
77
-
78
- Для работы с уже существующими отчетами доступен метод `read-report`, который позволяет нейросети прочитать содержимое отчета и использовать его для создания новых отчетов по запросу пользователя.
79
-
80
- **ВАЖНО:** Если пользователь просит изменить отчёт, добавить в него что-то, дополнить, расширить или отредактировать, то нейросеть сначала должна прочитать файл последнего отчета методом `report_gen_mcp : read-report`, затем создать новый файл отчета с добавлением нужного содержимого методом `report_gen_mcp : generate-report`. При этом следует использовать содержимое прочитанного отчета как основу для нового отчета, добавляя к нему запрошенные пользователем изменения.
81
-
82
- ### Метод read-report
83
-
84
- Метод `read-report` принимает путь к существующему HTML-отчету и возвращает его содержимое в структурированном виде, включая:
85
- - Заголовки и их уровни
86
- - Параграфы текста
87
- - Списки и их элементы
88
- - Информацию о диаграммах и изображениях
89
-
90
- После успешного чтения отчета с помощью метода `read-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
91
-
92
- 1. **Путь к файлу**: Абсолютный путь к прочитанному отчету
93
- 2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
94
- 3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
95
- 4. **Содержимое файла**: Полный текст HTML содержимого отчета
96
- 5. **Структурированное содержание**: Заголовки, параграфы, списки и элементы отчета
97
-
98
- ### После генерации нового отчета на основе существующего
99
-
100
- После успешной генерации нового отчета с помощью метода `generate-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
101
-
102
- ### 1. Предоставление информации пользователю
103
-
104
- Из ответа метода `generate-report` извлеките следующую информацию и предоставьте пользователю:
105
-
106
- 1. **Путь к файлу**: Абсолютный путь к созданному отчету
107
- 2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
108
- 3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
109
- 4. **Содержимое файла**: Полный текст HTML содержимого отчета
110
-
111
- Обязательно покажите пользователю содержимое файла, чтобы он мог сразу ознакомиться с результатом без необходимости открывать файл отдельно.
112
-
113
- **ВАЖНОЕ ТРЕБОВАНИЕ**: Отчет должен быть максимально красивым и качественным. Содержать изображения, графики, выводы и рассуждения. Отчет должен быть строго в HTML формате!
114
-
115
- **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
116
-
117
- **ОСОБЕННОСТИ РАБОТЫ С ИЗОБРАЖЕНИЯМИ:**
118
- - Если отчет содержит локальные изображения (file://), они могут не отображаться при открытии через file:// ссылку из-за ограничений безопасности браузера
119
- - Для корректного отображения всех изображений рекомендуется использовать Web link 2 (http://localhost:3000/...)
120
- - Пользователь также может открыть файл напрямую в браузере через file:// ссылку, если браузер позволяет загрузку локальных ресурсов
121
-
122
- Пример формата ответа пользователю:
123
- ```
124
- Отчет успешно создан!
125
-
126
- 📁 Путь к файлу: /полный/путь/к/отчету.html
127
- 🌐 Ссылка для открытия в браузере: file:///полный/путь/к/отчету.html
128
- 🔗 [Web link 2](http://localhost:3000/отчет.html)
129
-
130
- 📄 Содержимое отчета:
131
- <!DOCTYPE html>
132
- <html lang="ru">
133
- <head>
134
- <meta charset="UTF-8">
135
- <title>Отчет</title>
136
- <style>
137
- body {
138
- font-family: Arial, sans-serif;
139
- margin: 40px;
140
- background-color: #f5f5f5;
141
- }
142
- .container {
143
- max-width: 1200px;
144
- margin: 0 auto;
145
- background-color: white;
146
- padding: 30px;
147
- border-radius: 10px;
148
- box-shadow: 0 0 10px rgba(0,0,0,0.1);
149
- }
150
- h1, h2, h3 {
151
- color: #333;
152
- }
153
- h1 {
154
- border-bottom: 2px solid #3498db;
155
- padding-bottom: 10px;
156
- }
157
- h2 {
158
- border-left: 4px solid #3498db;
159
- padding-left: 15px;
160
- }
161
- .chart-container, .image-container {
162
- margin: 30px 0;
163
- text-align: center;
164
- }
165
- .chart-container canvas, .image-container img {
166
- max-width: 100%;
167
- height: auto;
168
- border: 1px solid #ddd;
169
- border-radius: 5px;
170
- }
171
- p {
172
- line-height: 1.6;
173
- text-align: justify;
174
- }
175
- ul, ol {
176
- margin: 20px 0;
177
- padding-left: 30px;
178
- }
179
- li {
180
- margin: 10px 0;
181
- }
182
- strong {
183
- color: #e74c3c;
184
- }
185
- em {
186
- color: #2ecc71;
187
- }
188
- </style>
189
- <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
190
- </head>
191
- <body>
192
- <div class="container">
193
- <h1>Отчет</h1>
194
- <div class="chart-container">
195
- <!-- Chart.js chart code -->
196
- </div>
197
- <div class="image-container">
198
- <!-- Generated image -->
199
- <img src="https://image.pollinations.ai/prompt/красивый%20закат" alt="красивый закат">
200
- </div>
201
- <h2>Анализ данных</h2>
202
- <p>На основании проведенного анализа можно сделать следующие выводы:</p>
203
- <ul>
204
- <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
205
- <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
206
- <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
207
- </ul>
208
- <h2>Рекомендации</h2>
209
- <ol>
210
- <li>Увеличить инвестиции в направления с высокой доходностью</li>
211
- <li>Оптимизировать расходы в менее эффективных сегментах</li>
212
- <li>Рассмотреть возможность расширения бизнеса</li>
213
- </ol>
214
- </div>
215
- </body>
216
- </html>
217
-
218
- 💡 Примечание: Если изображения не отображаются, попробуйте открыть отчет по Web link 2, который обеспечивает корректное отображение всех элементов.
219
-
220
- Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
221
- ```
222
-
223
- ### 2. Альтернативный подход (при необходимости)
224
-
225
- Если по какой-то причине информация не была получена напрямую из метода `generate-report`, можно использовать дополнительные инструменты:
226
-
227
- #### Получение информации о файле
228
-
229
- Используйте инструмент `get-report-url` для получения полной информации о созданном отчете:
230
-
231
- ```json
232
- {
233
- "method": "tools/call",
234
- "params": {
235
- "name": "get-report-url",
236
- "arguments": {
237
- "filePath": "/путь/к/созданному/отчету.html"
238
- }
239
- }
240
- }
241
- ```
242
-
243
- #### Прикрепление содержимого файла
244
-
245
- Для того чтобы пользователь мог сразу просмотреть содержимое отчета без необходимости открывать файл, используйте инструмент `get-report-file`:
246
-
247
- ```json
248
- {
249
- "method": "tools/call",
250
- "params": {
251
- "name": "get-report-file",
252
- "arguments": {
253
- "filePath": "/путь/к/созданному/отчету.html"
254
- }
255
- }
256
- }
257
- ```
258
-
259
- ### 3. Особенности работы с изображениями
260
-
261
- При генерации изображений с помощью инструментов `generate-image` или `edit-image`, нейросеть должна:
262
-
263
- 1. **Для `generate-image`** - обрабатывать ответ, содержащий:
264
- - Текстовое подтверждение генерации
265
- - Путь к файлу изображения на диске
266
- - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
267
- - Web link 2: `http://localhost:3000/имя_файла.jpg`
268
- - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
269
-
270
- 2. **Для `edit-image`** - обрабатывать ответ, содержащий:
271
- - Текстовое подтверждение редактирования
272
- - Путь к файлу изображения на диске
273
- - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
274
- - Web link 2: `http://localhost:3000/имя_файла.jpg`
275
- - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
276
-
277
- 3. **Важно**: Всегда показывайте пользователю Web link 2 для быстрого доступа к изображению через веб-интерфейс.
278
-
279
- 4. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.jpg)`!
280
-
281
- 5. **ОСОБЕННО ВАЖНО**: При генерации изображения обязательно прикладывайте путь к нему в виде https или http ссылки (img_link). Именно эту ссылку предпочтительнее всего использовать во всех отчетах!
282
-
283
- 6. **Пример корректного ответа при генерации изображения**:
284
- ```
285
- ✅ Изображение успешно сгенерировано по промпту: 'beautiful landscape'
286
-
287
- 📁 Файл сохранен: /полный/путь/к/generated-image-1234567890.jpeg
288
- 🌐 Web link: file:///полный/путь/к/generated-image-1234567890.jpeg
289
- 🔗 [Web link 2](http://localhost:3000/generated-image-1234567890.jpeg)
290
- 🖼️ img_link: http://localhost:3000/generated-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
291
-
292
- 💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
293
-
294
- Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
295
- ```
296
-
297
- 7. **Пример корректного ответа при редактировании изображения**:
298
- ```
299
- ✅ Изображение успешно отредактировано по промпту: 'add a hat to the person'
300
-
301
- 📁 Файл сохранен: /полный/путь/к/edited-image-1234567890.jpeg
302
- 🌐 Web link: file:///полный/путь/к/edited-image-1234567890.jpeg
303
- 🔗 [Web link 2](http://localhost:3000/edited-image-1234567890.jpeg)
304
- 🖼️ img_link: http://localhost:3000/edited-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
305
-
306
- 💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
307
-
308
- Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
309
- ```
310
-
311
- ## Формат данных для диаграмм (графиков)
312
-
313
- Очень важно правильно формировать данные для диаграмм, чтобы избежать ошибок. Ниже приведены точные требования к формату данных для каждого типа диаграмм.
314
-
315
- ### Общие правила для всех типов диаграмм
316
-
317
- 1. Все цветовые значения (`backgroundColor`, `borderColor`) должны быть представлены в виде **массивов строк**, даже если это один цвет.
318
- 2. Все числовые данные (`data`) должны быть представлены в виде массивов чисел.
319
- 3. Все текстовые метки (`labels`) должны быть представлены в виде массивов строк.
320
- 4. Значение `options.title` должно быть **строкой**, а не объектом.
321
-
322
- ### Линейные диаграммы (line)
323
-
324
- ```json
325
- {
326
- "type": "line",
327
- "config": {
328
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
329
- "datasets": [
330
- {
331
- "label": "Продажи (USD)",
332
- "data": [12000, 19000, 15000, 18000, 22000],
333
- "borderColor": ["rgba(54, 162, 235, 1)"], // ВАЖНО: массив, даже для одного цвета!
334
- "fill": false
335
- }
336
- ],
337
- "options": {
338
- "title": "Ежемесячные продажи"
339
- }
340
- }
341
- }
342
- ```
343
-
344
- **Важно**: `borderColor` должен быть массивом строк, даже если используется только один цвет.
345
-
346
- ### Столбчатые диаграммы (bar)
347
-
348
- ```json
349
- {
350
- "type": "bar",
351
- "config": {
352
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
353
- "datasets": [
354
- {
355
- "label": "Продажи (USD)",
356
- "data": [12000, 19000, 15000, 18000, 22000],
357
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
358
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
359
- }
360
- ],
361
- "options": {
362
- "title": "Ежемесячные продажи"
363
- }
364
- }
365
- }
366
- ```
367
-
368
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
369
-
370
- ### Круговые диаграммы (pie)
371
-
372
- ```json
373
- {
374
- "type": "pie",
375
- "config": {
376
- "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
377
- "datasets": [
378
- {
379
- "data": [12, 19, 3, 5, 2],
380
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
381
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
382
- }
383
- ],
384
- "options": {
385
- "title": "Распределение по категориям"
386
- }
387
- }
388
- }
389
- ```
390
-
391
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
392
-
393
- ### Кольцевые диаграммы (doughnut)
394
-
395
- ```json
396
- {
397
- "type": "doughnut",
398
- "config": {
399
- "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
400
- "datasets": [
401
- {
402
- "data": [12, 19, 3, 5, 2],
403
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
404
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
405
- }
406
- ],
407
- "options": {
408
- "title": "Распределение по категориям"
409
- }
410
- }
411
- }
412
- ```
413
-
414
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
415
-
416
- ### Радарные диаграммы (radar)
417
-
418
- ```json
419
- {
420
- "type": "radar",
421
- "config": {
422
- "labels": ["Eating", "Drinking", "Sleeping", "Designing", "Coding", "Cycling", "Running"],
423
- "datasets": [
424
- {
425
- "label": "Person 1",
426
- "data": [65, 59, 90, 81, 56, 55, 40],
427
- "backgroundColor": ["rgba(255, 99, 132, 0.2)"], // Массив цветов
428
- "borderColor": ["rgba(255, 99, 132, 1)"] // Массив цветов
429
- }
430
- ],
431
- "options": {
432
- "title": "Радарная диаграмма"
433
- }
434
- }
435
- }
436
- ```
437
-
438
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
439
-
440
- ### Полярные диаграммы (polarArea)
441
-
442
- ```json
443
- {
444
- "type": "polarArea",
445
- "config": {
446
- "labels": ["Red", "Green", "Yellow", "Grey", "Blue"],
447
- "datasets": [
448
- {
449
- "data": [11, 16, 7, 3, 14],
450
- "backgroundColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"], // Массив цветов
451
- "borderColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"] // Массив цветов
452
- }
453
- ],
454
- "options": {
455
- "title": "Полярная диаграмма"
456
- }
457
- }
458
- }
459
- ```
460
-
461
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк.
462
-
463
- ## Формат данных для изображений
464
-
465
- ### Изображения, сгенерированные pollinations.ai
466
-
467
- ```json
468
- {
469
- "type": "pollinations",
470
- "config": {
471
- "prompt": "красивый закат над океаном",
472
- "width": 512,
473
- "height": 512,
474
- "model": "flux",
475
- "seed": 12345,
476
- "nologo": true,
477
- "enhance": true
478
- }
479
- }
480
- ```
481
-
482
- ### Изображения, сгенерированные с помощью generate-image (Chutes AI)
483
-
484
- При использовании инструмента `generate-image` для генерации изображений с помощью Chutes AI, числовые параметры могут быть представлены как числа или как строки. Инструмент автоматически преобразует строковые параметры в числа.
485
-
486
- ✅ ПРИМЕР 1 (числовые параметры как числа):
487
- ```json
488
- {
489
- "method": "tools/call",
490
- "params": {
491
- "name": "generate-image",
492
- "arguments": {
493
- "prompt": "a dog made of US dollar bills",
494
- "width": 512,
495
- "height": 512,
496
- "guidance_scale": 7.5,
497
- "negative_prompt": "blurry, low quality",
498
- "num_inference_steps": 50,
499
- "seed": 0
500
- }
501
- }
502
- }
503
- ```
504
-
505
- ✅ ПРИМЕР 2 (числовые параметры как строки):
506
- ```json
507
- {
508
- "method": "tools/call",
509
- "params": {
510
- "name": "generate-image",
511
- "arguments": {
512
- "prompt": "a dog made of US dollar bills",
513
- "width": "512",
514
- "height": "512",
515
- "guidance_scale": "7.5",
516
- "negative_prompt": "blurry, low quality",
517
- "num_inference_steps": "50",
518
- "seed": "0"
519
- }
520
- }
521
- }
522
- ```
523
-
524
- ✅ ПРИМЕР 3 (смешанные параметры):
525
- ```json
526
- {
527
- "method": "tools/call",
528
- "params": {
529
- "name": "generate-image",
530
- "arguments": {
531
- "prompt": "a dog made of US dollar bills",
532
- "width": "512",
533
- "height": 512,
534
- "guidance_scale": "7.5",
535
- "negative_prompt": "blurry, low quality",
536
- "num_inference_steps": 50,
537
- "seed": "0"
538
- }
539
- }
540
- }
541
- ```
542
-
543
- **Гибкость параметров:** Инструмент поддерживает как числовые, так и строковые значения для числовых параметров (`width`, `height`, `guidance_scale`, `num_inference_steps`, `seed`). Это обеспечивает совместимость с различными способами формирования запросов.
544
-
545
- **ПРАВИЛЬНОЕ ИСПОЛЬЗОВАНИЕ РЕЗУЛЬТАТА generate-image В ОТЧЕТАХ:**
546
-
547
- Когда вы получаете ответ от `generate-image`, он имеет следующую структуру:
548
- ```json
549
- {
550
- "content": [
551
- {
552
- "type": "text",
553
- "text": "✅ Image successfully generated from prompt: 'your prompt'"
554
- }
555
- ],
556
- "filePath": "/полный/путь/к/generated-image-1234567890.jpeg",
557
- "fileUrl": "file:///полный/путь/к/generated-image-1234567890.jpeg"
558
- }
559
- ```
560
-
561
- Чтобы использовать это изображение в отчете с помощью `generate-report`, извлеките `fileUrl` из ответа и используйте его в элементе отчета:
562
-
563
- ```json
564
- {
565
- "method": "tools/call",
566
- "params": {
567
- "name": "generate-report",
568
- "arguments": {
569
- "document": "# Отчет\n\n[[image:generated_img]]",
570
- "elements": {
571
- "generated_img": {
572
- "type": "url",
573
- "config": {
574
- "url": "file:///полный/путь/к/generated-image-1234567890.jpeg", // <- Используйте fileUrl из предыдущего ответа
575
- "alt": "Сгенерированное изображение",
576
- "width": 512,
577
- "height": 512
578
- }
579
- }
580
- },
581
- "outputFile": "report.html"
582
- }
583
- }
584
- }
585
- ```
586
-
587
- ### Изображения по URL
588
-
589
- ```json
590
- {
591
- "type": "url",
592
- "config": {
593
- "url": "https://example.com/image.jpg",
594
- "alt": "Описание изображения",
595
- "width": 500,
596
- "height": 300
597
- }
598
- }
599
- ```
600
-
601
- ### Локальные изображения (по файловому пути)
602
-
603
- ```json
604
- {
605
- "type": "url",
606
- "config": {
607
- "url": "file:///полный/путь/к/изображению.jpg",
608
- "alt": "Описание изображения",
609
- "width": 500,
610
- "height": 300
611
- }
612
- }
613
- ```
614
-
615
- **ВАЖНО ПРИ РАБОТЕ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
616
- - Локальные изображения должны быть указаны с полным путем в формате file://
617
- - Браузеры могут блокировать отображение локальных файлов по соображениям безопасности
618
- - Для корректного отображения используйте Web link 2 (http://localhost:3000/...)
619
-
620
- ## ПРАВИЛА ФОРМАТИРОВАНИЯ ПАРАМЕТРОВ (КРИТИЧЕСКИ ВАЖНО!)
621
-
622
- ### 1. ПАРАМЕТР "elements" ДОЛЖЕН БЫТЬ ОБЪЕКТОМ!
623
-
624
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку "Expected object, received string"):
625
- ```json
626
- {
627
- "method": "generate-report",
628
- "params": {
629
- "document": "# Отчет\n\n[[chart:mychart]]",
630
- "elements": "{ \"mychart\": { \"type\": \"bar\", \"config\": { \"labels\": [\"A\", \"B\", \"C\"], \"datasets\": [{ \"label\": \"Data\", \"data\": [1, 2, 3], \"backgroundColor\": [\"red\", \"green\", \"blue\"], \"borderColor\": [\"red\", \"green\", \"blue\"] }] } }",
631
- "outputFile": "report.html"
632
- }
633
- }
634
- ```
635
-
636
- ✅ ПРАВИЛЬНО (elements - это объект, а не строка):
637
- ```json
638
- {
639
- "method": "generate-report",
640
- "params": {
641
- "document": "# Отчет\n\n[[chart:mychart]]",
642
- "elements": {
643
- "mychart": {
644
- "type": "bar",
645
- "config": {
646
- "labels": ["A", "B", "C"],
647
- "datasets": [{
648
- "label": "Data",
649
- "data": [1, 2, 3],
650
- "backgroundColor": ["red", "green", "blue"],
651
- "borderColor": ["red", "green", "blue"]
652
- }],
653
- "options": {
654
- "title": "Мой график"
655
- }
656
- }
657
- }
658
- },
659
- "outputFile": "report.html"
660
- }
661
- }
662
- ```
663
-
664
- ### 2. ЦВЕТОВЫЕ ЗНАЧЕНИЯ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
665
-
666
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
667
- ```json
668
- "backgroundColor": "red"
669
- "borderColor": "blue"
670
- ```
671
-
672
- ✅ ПРАВИЛЬНО (всегда используйте массивы):
673
- ```json
674
- "backgroundColor": ["red"]
675
- "borderColor": ["blue"]
676
- ```
677
-
678
- ### 3. ЧИСЛОВЫЕ ДАННЫЕ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
679
-
680
- ❌ НЕПРАВИЛЬНО:
681
- ```json
682
- "data": 10
683
- ```
684
-
685
- ✅ ПРАВИЛЬНО:
686
- ```json
687
- "data": [10]
688
- ```
689
-
690
- ### 4. ТЕКСТОВЫЕ МЕТКИ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
691
-
692
- ❌ НЕПРАВИЛЬНО:
693
- ```json
694
- "labels": "Январь"
695
- ```
696
-
697
- ✅ ПРАВИЛЬНО:
698
- ```json
699
- "labels": ["Январь"]
700
- ```
701
-
702
- ### 5. ЗНАЧЕНИЕ options.title ДОЛЖНО БЫТЬ СТРОКОЙ!
703
-
704
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
705
- ```json
706
- "options": {
707
- "title": {
708
- "text": "Заголовок графика"
709
- }
710
- }
711
- ```
712
-
713
- ✅ ПРАВИЛЬНО:
714
- ```json
715
- "options": {
716
- "title": "Заголовок графика"
717
- }
718
- ```
719
-
720
- ### 6. ТИП ЭЛЕМЕНТА ДОЛЖЕН СООТВЕТСТВОВАТЬ ЕГО СОДЕРЖИМОМУ!
721
-
722
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
723
- ```json
724
- "comparison_chart": {
725
- "type": "bar", // Неправильный тип для сравнения - должен быть либо "pollinations", либо "url"
726
- "config": {
727
- "labels": ["A", "B", "C"],
728
- "datasets": [{
729
- "label": "Data",
730
- "data": [1, 2, 3],
731
- "backgroundColor": ["red", "green", "blue"]
732
- }]
733
- }
734
- }
735
- ```
736
-
737
- ✅ ПРАВИЛЬНО (для диаграмм):
738
- ```json
739
- "comparison_chart": {
740
- "type": "bar",
741
- "config": {
742
- "labels": ["A", "B", "C"],
743
- "datasets": [{
744
- "label": "Data",
745
- "data": [1, 2, 3],
746
- "backgroundColor": ["red", "green", "blue"]
747
- }],
748
- "options": {
749
- "title": "Сравнительная диаграмма"
750
- }
751
- }
752
- }
753
- ```
754
-
755
- ✅ ПРАВИЛЬНО (для изображений):
756
- ```json
757
- "comparison_chart": {
758
- "type": "pollinations",
759
- "config": {
760
- "prompt": "beautiful landscape with mountains",
761
- "width": 600,
762
- "height": 400
763
- }
764
- }
765
- ```
766
-
767
- ✅ ПРАВИЛЬНО (для локальных изображений):
768
- ```json
769
- "comparison_chart": {
770
- "type": "url",
771
- "config": {
772
- "url": "file:///полный/путь/к/изображению.jpg",
773
- "alt": "Локальное изображение",
774
- "width": 500,
775
- "height": 300
776
- }
777
- }
778
- ```
779
-
780
- ## Пример полного взаимодействия
781
-
782
- Вот пример того, как должно выглядеть полное взаимодействие с пользователем после генерации отчета:
783
-
784
- 1. Генерация отчета с диаграммами:
785
43
  ```json
786
44
  {
787
45
  "method": "generate-report",
788
46
  "params": {
789
- "document": "# Отчет\n\n[[chart:sales_chart]]\n\n[[chart:comparison_chart]]",
47
+ "document": "# Отчет о продажах\n\nАнализ квартальных продаж.\n\n[[chart:sales]]\n\n![бизнес-успех]([[image:success]])",
790
48
  "elements": {
791
- "sales_chart": {
49
+ "sales": {
792
50
  "type": "bar",
793
51
  "config": {
794
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
52
+ "labels": ["Q1", "Q2", "Q3", "Q4"],
795
53
  "datasets": [{
796
- "label": "Продажи (USD)",
797
- "data": [12000, 19000, 15000, 18000, 22000],
798
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"],
799
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"]
54
+ "label": "Продажи 2024",
55
+ "data": [120, 150, 130, 180],
56
+ "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0"]
800
57
  }],
801
58
  "options": {
802
- "title": "Ежемесячные продажи"
59
+ "title": "Квартальные продажи"
803
60
  }
804
61
  }
805
62
  },
806
- "comparison_chart": {
807
- "type": "pie",
808
- "config": {
809
- "labels": ["Категория A", "Категория B", "Категория C"],
810
- "datasets": [{
811
- "data": [30, 50, 20],
812
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56"],
813
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56"]
814
- }],
815
- "options": {
816
- "title": "Сравнение по категориям"
817
- }
818
- }
819
- }
820
- },
821
- "outputFile": "report.html"
822
- }
823
- }
824
- ```
825
-
826
- 2. Генерация отчета с изображениями:
827
- ```json
828
- {
829
- "method": "generate-report",
830
- "params": {
831
- "document": "# Отчет\n\n[[image:main_image]]\n\n[[image:comparison_image]]\n\n[[image:local_image]]",
832
- "elements": {
833
- "main_image": {
63
+ "success": {
834
64
  "type": "pollinations",
835
65
  "config": {
836
- "prompt": "beautiful landscape with mountains and lake",
837
- "width": 600,
838
- "height": 400,
839
- "model": "flux",
840
- "nologo": true,
841
- "enhance": true
842
- }
843
- },
844
- "comparison_image": {
845
- "type": "url",
846
- "config": {
847
- "url": "https://example.com/comparison-diagram.jpg",
848
- "alt": "Сравнительная диаграмма",
849
- "width": 500,
850
- "height": 300
851
- }
852
- },
853
- "local_image": {
854
- "type": "url",
855
- "config": {
856
- "url": "file:///полный/путь/к/local-image.jpg",
857
- "alt": "Локальное изображение",
858
- "width": 500,
859
- "height": 300
66
+ "prompt": "график роста и успеха в бизнесе"
860
67
  }
861
68
  }
862
69
  },
863
- "outputFile": "report.html"
70
+ "outputFile": "sales_report.html"
864
71
  }
865
72
  }
866
73
  ```
867
74
 
868
- 3. Ответ от метода `generate-report` уже содержит всю необходимую информацию:
869
- ```json
870
- {
871
- "content": [
872
- {
873
- "type": "text",
874
- "text": "Report generated successfully.\n\nFOR THE NEURAL NETWORK: Please present the following information to the user:\n1. Path to file: /path/to/report.html\n2. Web browser link: file:///path/to/report.html\n3. Web link 2: http://localhost:3000/report.html"
875
- }
876
- ]
877
- }
878
- ```
879
-
880
- 4. Ответ пользователю (на основе информации из ответа метода):
881
- ```
882
- Отчет успешно создан!
883
-
884
- 📁 Путь к файлу: /path/to/report.html
885
- 🌐 Ссылка для открытия в браузере: file:///path/to/report.html
886
- 🔗 [Web link 2](http://localhost:3000/report.html)
887
-
888
- 💡 Примечание: Если изображения не отображаются, попробуйте открыть отчет по Web link 2, который обеспечивает корректное отображение всех элементов, включая локальные изображения.
889
-
890
- Содержимое отчета:
891
- <!DOCTYPE html>
892
- <html lang="ru">
893
- <head>
894
- <meta charset="UTF-8">
895
- <title>Отчет</title>
896
- <style>
897
- body {
898
- font-family: Arial, sans-serif;
899
- margin: 40px;
900
- background-color: #f5f5f5;
901
- }
902
- .container {
903
- max-width: 1200px;
904
- margin: 0 auto;
905
- background-color: white;
906
- padding: 30px;
907
- border-radius: 10px;
908
- box-shadow: 0 0 10px rgba(0,0,0,0.1);
909
- }
910
- h1, h2, h3 {
911
- color: #333;
912
- }
913
- h1 {
914
- border-bottom: 2px solid #3498db;
915
- padding-bottom: 10px;
916
- }
917
- h2 {
918
- border-left: 4px solid #3498db;
919
- padding-left: 15px;
920
- }
921
- .chart-container, .image-container {
922
- margin: 30px 0;
923
- text-align: center;
924
- }
925
- .chart-container canvas, .image-container img {
926
- max-width: 100%;
927
- height: auto;
928
- border: 1px solid #ddd;
929
- border-radius: 5px;
930
- }
931
- p {
932
- line-height: 1.6;
933
- text-align: justify;
934
- }
935
- ul, ol {
936
- margin: 20px 0;
937
- padding-left: 30px;
938
- }
939
- li {
940
- margin: 10px 0;
941
- }
942
- strong {
943
- color: #e74c3c;
944
- }
945
- em {
946
- color: #2ecc71;
947
- }
948
- </style>
949
- <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
950
- </head>
951
- <body>
952
- <div class="container">
953
- <h1>Отчет</h1>
954
- <div class="chart-container">
955
- <!-- Chart.js chart code -->
956
- </div>
957
- <div class="image-container">
958
- <!-- Generated image -->
959
- <img src="https://image.pollinations.ai/prompt/beautiful%20landscape%20with%20mountains%20and%20lake" alt="beautiful landscape with mountains and lake">
960
- </div>
961
- <h2>Анализ данных</h2>
962
- <p>На основании проведенного анализа можно сделать следующие выводы:</p>
963
- <ul>
964
- <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
965
- <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
966
- <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
967
- </ul>
968
- <h2>Рекомендации</h2>
969
- <ol>
970
- <li>Увеличить инвестиции в направления с высокой доходностью</li>
971
- <li>Оптимизировать расходы в менее эффективных сегментах</li>
972
- <li>Рассмотреть возможность расширения бизнеса</li>
973
- </ol>
974
- </div>
975
- </body>
976
- </html>
977
-
978
- Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
979
- ```
980
-
981
- ## Частые ошибки и как их избежать
982
-
983
- 1. **Ошибка формата параметров**: Передача `elements` как строки вместо объекта
984
- - ❌ Неправильно: `"elements": "{\"mychart\":{...}}"`
985
- - ✅ Правильно: `"elements": {"mychart":{...}}"
986
-
987
- 2. **Ошибка формата цвета**: Передача `borderColor` или `backgroundColor` как строк вместо массивов
988
- - ❌ Неправильно: `"borderColor": "red"`
989
- - ✅ Правильно: `"borderColor": ["red"]"
990
-
991
- 3. **Ошибка формата данных**: Передача числовых данных как отдельных значений вместо массивов
992
- - ❌ Неправильно: `"data": 10
993
- - ✅ Правильно: `"data": [10]"
994
-
995
- 4. **Ошибка формата меток**: Передача меток как отдельных значений вместо массивов
996
- - ❌ Неправильно: `"labels": "Январь"
997
- - ✅ Правильно: `"labels": ["Январь"]"
998
-
999
- 5. **Ошибка формата заголовка**: Передача `options.title` как объекта вместо строки
1000
- - ❌ Неправильно: `"options": {"title": {"text": "Заголовок"}}`
1001
- - ✅ Правильно: `"options": {"title": "Заголовок"}`
1002
-
1003
- 6. **Ошибка типа элемента**: Использование неправильного типа для элемента
1004
- - ❌ Неправильно: `"type": "bar"` для изображения
1005
- - ✅ Правильно: `"type": "pollinations"` или `"type": "url"` для изображений
1006
-
1007
- 7. **Ошибка с локальными изображениями**: Неправильный формат file:// URL
1008
- - ❌ Неправильно: `"url": "/путь/к/изображению.jpg"`
1009
- - ✅ Правильно: `"url": "file:///полный/путь/к/изображению.jpg"`
1010
-
1011
- ## Дополнительные рекомендации
1012
-
1013
- 1. Всегда проверяйте успешность выполнения каждой операции перед переходом к следующему шагу
1014
- 2. Если какой-либо шаг завершается ошибкой, сообщите пользователю об этом и предложите решение
1015
- 3. Убедитесь, что все пути к файлам корректны и файлы действительно существуют
1016
- 4. При работе с Claude Desktop используйте параметр `tempDirectory` при генерации отчетов для избежания проблем с правами доступа
1017
- 5. Создавайте отчеты с красивым оформлением, используя заголовки, списки и другие элементы форматирования
1018
- 6. Добавляйте в отчеты диаграммы и изображения для лучшей визуализации данных
1019
- 7. Всегда после генерации отчета возвращайте пользователю ссылку на файл отчета, путь к файлу отчета и содержимое файла
1020
- 8. Отчет должен быть максимально красивым и качественным, содержать изображения, графики, выводы и рассуждения
1021
- 9. Отчет должен быть строго в HTML формате
1022
- 10. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
1023
- 11. **ОСОБЕННО ВАЖНО**: При использовании локальных изображений всегда добавляйте примечание о том, что для корректного отображения следует использовать Web link 2
75
+ ## 6. Ответ пользователю
1024
76
 
1025
- Следование этим инструкциям обеспечит качественное и полное взаимодействие с пользователем при работе с инструментом генерации отчетов.
77
+ После успешной генерации отчета предоставьте пользователю:
78
+ 1. **Путь к файлу** (из ответа инструмента).
79
+ 2. **Ссылку `file://`** для локального открытия.
80
+ 3. **Ссылку `http://localhost:3000/...`** (Web link 2) для надежного отображения всех элементов.
81
+ 4. **Полное содержимое HTML-файла**.